<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic
  PUBLIC "-//OASIS//DTD DITA Composite//EN" "ditabase.dtd">
<topic id="topic1">
  <title id="mb20941">gpmemreport</title>
  <body>
    <p>Interprets the output created by the <xref href="./gpmemwatcher.xml#topic1" type="topic"
        format="dita"/> utility and generates output files in a readable format.</p>
    <section id="section2">
      <title>Synopsis</title>
      <codeblock>gpmemreport [&lt;GZIP_FILE>] [[-s &lt;START>] | [--start= &lt;START>]] [[-e &lt;END>] | [--end= &lt;END>]] 
        
gpmemreport --version

gpmemreport -h | --help </codeblock>
    </section>
    <section id="section3">
      <title>Description</title>
      <p>The <codeph>gpmemreport</codeph> utility helps interpret the output file created by the
          <xref href="./gpmemwatcher.xml#topic1" type="topic" format="dita"/> utility. </p>
      <p>When running <codeph>gpmemreport</codeph> against the <codeph>.gz</codeph> files generated
        by <codeph>gpmemwatcher</codeph>, it generates a series of files, where each file
        corresponds to a 60 second period of data collected by <codeph>gpmemwatcher</codeph>
        converted into a readable format. </p>
    </section>
    <section id="section4">
      <title>Options</title>
      <parml>
        <plentry>
          <pt>-s | --start <varname>start_time</varname></pt>
          <pd>Indicates the start of the reporting period. Timestamp format must be
              <codeph>'%Y-%m-%d %H:%M:%S'</codeph>.</pd>
        </plentry>
        <plentry>
          <pt>-e | --end <varname>end_time</varname></pt>
          <pd>Indicates the end of the reporting period.  Timestamp format must be <codeph>'%Y-%m-%d
              %H:%M:%S'</codeph>.</pd>
        </plentry>
        <plentry>
          <pt>--version</pt>
          <pd>Displays the version of this utility.</pd>
        </plentry>
        <plentry>
          <pt>-h | --help</pt>
          <pd>Displays the online help.</pd>
        </plentry>
      </parml>
    </section>
    <section id="section5">
      <title>Examples</title>
      <p><b>Example 1: Extract all the files generated by <codeph>gpmemwatcher</codeph> for the
          Greenplum master</b></p>
      <p>Locate the output <codeph>.gz</codeph> file from <codeph>gpmemwatcher</codeph> and run
          <codeph>gpmemreport</codeph> against
        it:<codeblock>$ gpmemreport mdw.ps.out.gz
>>>21:11:19:15:37:18&lt;&lt;&lt;

>>>21:11:19:15:38:18&lt;&lt;&lt;

>>>21:11:19:15:39:18&lt;&lt;&lt;
</codeblock>
      </p>
      <p>Check that the generated files are
        listed under the current directory:<codeblock>$ ls -thrl
-rw-rw-r--. 1 gpadmin gpadmin 1.2K Nov 19 15:50 20211119-153718
-rw-rw-r--. 1 gpadmin gpadmin 1.2K Nov 19 15:50 20211119-153818
-rw-rw-r--. 1 gpadmin gpadmin 1.2K Nov 19 15:50 20211119-153918</codeblock></p>
      <p><b>Example 2: Extract the files generated by <codeph>gpmemwatcher</codeph> for the
          Greenplum master starting after a certain timestamp</b></p>
      <p>Locate the output <codeph>.gz</codeph> file from <codeph>gpmemwatcher</codeph> and run
          <codeph>gpmemreport</codeph> against it, indicating the start time as <codeph>2021-11-19
          15:38:00</codeph>:<codeblock>$ gpmemreport mdw.ps.out.gz --start='2021-11-19 15:38:00'
>>>21:11:19:15:37:18&lt;&lt;&lt;

>>>21:11:19:15:38:18&lt;&lt;&lt;

>>>21:11:19:15:39:18&lt;&lt;&lt;</codeblock>
      </p>
      <p>Check under the current directory that only the selected timestamp files are
        listed:<codeblock>$ ls -thrl
-rw-rw-r--. 1 gpadmin gpadmin 1.2K Nov 19 15:50 20211119-153818
-rw-rw-r--. 1 gpadmin gpadmin 1.2K Nov 19 15:50 20211119-153918</codeblock></p>
    </section>
    <section id="section6">
      <title>See Also</title>
      <p>
        <xref href="./gpmemwatcher.xml#topic1" type="topic" format="dita"/></p>
    </section>
  </body>
</topic>
